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SECTION  1 
INTRODUCTION 


The  Text  Editor  (TE)  is  an  application  in  the  IISS  that 
provides  users  with  file  editing  capabilities.  Editing 
functions  include  inserting,  deleting,  moving,  and  replacing 
text . 

There  are  two  Text  Editor  modes,  edit  and  command. 

o  Edit  mode  is  used  to  enter  text  and  perform  editing 
functions  by  pressing  function  keys. 

o  Command  mode  is  used  to  perform  editing  functions  that 
require  additional  information  from  the  user  such  as  a 
file  name  or  search  string.  The  command  mode  commands 
are  SEARCH,  REPLACE,  LOAD,  SAVE,  CLEAR,  MARGINS,  REPEAT, 
BUFFER. 

NOTE:  Do  not  confuse  the  modes  of  the  Text  Editor  described 

above  with  the  keyboard  modes  such  as  "applcation" , 

"scrll/page" ,  "text  edit"  and  "window  mgr"  documented  in  section 
3  of  the  IISS  Terminal  Operator  Guide.  The  Text  Editor 
documented  in  this  manual  is  an  application  available  in  the 
IISS  and  in  order  to  use  the  special  function  keys  the  keyboard 
must  be  in  "applcation"  mode. 

1.1  Intended  Audience 


This  manual  is  intended  for  people  who  want  to  create  or 
modify  files  using  the  Text  Editor  Application  of  the  IISS. 

1.2  Documentation  Conventions 


This  manual  assumes  that  you  are  familiar  with  the  concept 
of  buffers.  Two  buffers  are  used  in  the  TE.  They  are 
the  workspace  buffer  and  the  cut  and  paste  buffer.  When  editing 
an  existing  file,  a  duplicate  copy  of  the  file's  contents  is  put 
into  the  workspace  buffer.  The  contents  of  this  buffer  appears 
on  your  terminal  screen  a  page  at  a  time.  On  a  VTIOO  terminal, 
each  page  is  22  lines  of  text.  The  text  that  you  insert  or 
revise  in  workspace  stays  there  until  you  save  your  edits  (with 
the  SAVE  command)  or  delete  them  (with  CLEAR  or  QUIT) .  If  you 
save  your  edits,  a  new  file  is  created.  Existing  versions  of 
the  file  remain  unchanged.  The  cut  and  paste  buffer  is  used  as 
temporary  storage  to  enable  you  to  move  text  around  in  the 
workspace  buffer. 

In  the  examples,  the  current  cursor  position  is  indicated 
by  an  underscore.  To  conserve  space,  the  example  screen  page 
size  is  10  lines  except  when  more  lines  are  needed  to 
demonstrate  the  functionality. 

Uppercase  words  enclosed  in  angle  brackets  denote  function 
keys  (.e.,  <QUIT>) .  Each  key  is  described  in  terms  of  the 
operation  that  is  performed  when  you  press  that  key.  Figure  1-1 
describes  which  programmable  function  keys  perform  the  Text 
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Editor  functions.  Appendix  B  of  the  IISS  Terminal  Operator 
Guide  shows  the  actual  keyboard  key  or  key  sequence  that  maps  to 
the  programmable  function  keys  for  various  terminals.  Figure 
1-2  shows  the  function  key  layout  for  the  Text  Editor  on  a  VTIOO 
keypad.  Because  the  Text  Editor  is  an  application  of  the  IISS, 
the  mode  item  which  is  in  the  lower  right  corner  of  the  screen, 
must  be  toggled  to  display  "applcation”  when  you  want  to  use  the 
Text  Editor  function  keys.  How  to  change  modes  and  a 
description  of  the  other  available  modes  is  explained  in  the 
IISS  Terminal  Operator  Guide. 


PROGRAMMABLE  FUNCTION  KEY  TEXT  EDITOR  FUNCTION 


PF5 

PF7 

PF8 

PF9 

PFIO 

PFll 

PF12 

PF13 

PF14 

PF16 


<COMMAND> 

<FIRST  PAGE> 
<LAST  PAGE> 
<INSERT  LINE> 
<DELETE  LINE> 
<PASTE> 

<FILL> 

<MIDLINE  BREAK> 
<SELECT> 

<SEARCH  NEXT> 


Figure  1-1  Function  Key  Mapping 
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Figure  1-2  Text  Editor  Application  Keypad  Layout 
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SECTION  2 
DOCUMENTS 


2 . 1  Reference  Documents 

[1]  Structural  Dynamics  Research  Corporation,  Text  Editor 
Development  Specification,  DS  620344600,  31  March 
1988. 

[2]  I CAM  Documentation  Standards,  ICAM  Document  IDS 
150120000c,  15  September  1983. 

This  manual  is  one  of  a  set  of  user  manuals  that  together 
describe  how  to  operate  in  the  IISS  environment.  The  complete 
set  consists  of  the  following  manuals  listed  here  for  reference: 

[1]  Structural  Dynamics  Research  Corporation,  IISS  Form 
Editor  User  Manual ,  UM  6203444400,  31  May  1988. 

Explains  how  to  define  and  maintain  electronic  forms. 
It  is  intended  to  be  used  by  programmers  writing 
application  programs  that  use  the  Form  Processor. 

[2]  Structural  Dynamics  Research  Corporation,  IISS  Form 
Processor  User  Manual ,  UM  620344200,  31  May  1988. 

Describes  the  set  of  callable  execution  time  routines 
available  to  an  application  program  to  process 
electronic  forms.  It  is  intended  to  be  used  by 
programmers  writing  application  programs  for  the  IISS 
environment . 

[3]  Structural  Dynamics  Research  Corporation,  IISS 
Terminal  Operator  Guide ,  OM  620344000,  31  May  1988. 

Explains  how  to  operate  the  generic  IISS  terminal  when 
running  an  IISS  application  program.  The  IISS  end 
user  environment,  function  selection  and  some 
predefined  applications  are  also  described. 
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[4]  Structural  Dynamics  Research  Corporation,  IISS  Text 
Editor  User  Manual ,  UM  620344600,  31  May  1988. 

Explains  how  to  use  the  file  editing  functions 
including:  inserting,  deleting,  moving  and  replacing 
text . 

[5]  Structural  Dynamics  Research  Corporation,  IISS  Rapid 
Application  Generator  User  Manual ,  UM  620344502,  31 
March  1988. 

Describes  the  Application  Definition  Language  and  the 
process  used  for  translating  textual  definitions  of 
interactive  database  applications  into  programs  that 
access  selected  data  base  information  resident  in  ae 
Common  Data  Model.  This  information  is  accessible 
through  the  IISS  Neutral  Data  Manipulation  Language. 

[6]  Structural  Dynamics  Research  Corporation,  IISS  Report 
Writer  User  Manual ,  UM  620344501,  31  May  1988. 

Describes  the  Report  Definition  Language  and  the 
process  of  creating  a  hard  copy  report  of  selected 
data  base  information  resident  in  the  Common  Data 
Model.  This  information  is  accessible  through  the 
IISS  Neutral  Data  Manipulation  Language. 

[7]  Structural  Dynamics  Research  Corporation,  IISS 
Virtual  Terminal  User  Manual ,  UM  620344300,  3i 
March  1988. 

Explains  the  program  callable  interface  to  the  IISS 
Virtual  Terminal.  The  callable  routines,  Virtual 
Terminal  commands  and  the  implementation  of  additional 
terminals  are  described.  It  is  intended  for 
application  and  system  programmers  working  in  the  IISS 
environment . 

2.2  Terms  and  Abbreviations 


Buffer  Name:  the  default  file  in  which  the  buffer  will  be 
saved  if  no  file  is  given  on  a  save  command. 

Current  Cursor  Position:  the  position  of  the  cursor  before 
an  edit  command  or  function  is  issued  in  the  text  editor. 
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Cursor  Position:  the  position  of  the  cursor  after  any 
command  is  issued. 

Cut  and  Paste  Buffer;  where  deleted  lines  go  and  the  paste 
and  fill  edit  commands  get  their  data. 

Display  Start  Line;  the  first  line  in  the  buffer  to  be 
displayed . 

Display  Size :  the  number  of  lines  used  in  the  edit  area. 

Field ;  two  dimensional  space  on  a  terminal  screen. 

Field  Pointer:  indicates  the  ITEM  which  contains  the 
current  cursor  position. 

Form  Processor;  (FP) ,  subset  of  the  IISS  User  Interface 
that  consists  of  a  set  of  callable  execution  time  routines 
available  to  an  application  program  for  form  processing. 

Form  Processor  Text  Editor:  (FPTE) ,  subset  of  the  Form 
Processor  that  consists  of  software  modules  that  provide  text 
editing  capabilities  to  all  users  of  applications  that  use  the 
Form  Processor. 

IISS  Function  Screen ;  the  first  screen  that  is  displayed 
after  logon.  It  allows  the  user  to  specify  the  function  he 
wants  to  access  and  the  device  type  and  device  name  on  which  he 
is  working. 

Integrated  Information  Support  System;  (IISS) ,  a  computing 
environment  used  to  investigate,  demonstrate,  test  the  concepts 
and  produce  application  for  information  management  and 
information  integration  in  the  context  of  Aerospace 
Manufacturing.  The  IISS  addresses  the  problems  of  integration 
of  data  resident  on  heterogeneous  data  bases  supported  by 
heterogeneous  computers  interconnected  via  a  Local  Area  Network. 

Item:  non-decomposable  area  of  a  form  in  which  hard-coded 
descriptive  text  may  be  placed  and  the  only  defined  areas  where 
user  data  may  be  input/output. 

Message ;  descriptive  text  which  may  be  returned  in  the 
standard  message  line  on  the  terminal  screen.  They  are  used  to 
warn  of  errors  or  provide  other  user  information. 
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Message  Line;  a  line  on  the  terminal  screen  that  is  used  to 
display  messages. 

Operatincy  System;  (OS)  ,  software  supplied  with  a  computer 
which  allows  it  to  supervise  its  own  operations  and  manage 
access  to  hardware  facilities  such  as  memory  and  peripherals. 

Paging  and  Scrolling ;  a  method  which  allows  a  form  to 
contain  more  data  than  can  be  displayed  with  provisions  for 
viewing  any  portion  of  the  data  buffer. 

Previous  Cursor  Position;  the  position  of  the  cursor  when 
the  previous  edit  command  was  issued. 

Previous  Edit  Command ;  the  function  key  pressed  before  the 
current  one. 

Select  Line ;  one  terminus  of  the  select  range. 

Select  Mode;  when  on,  certain  commands  will  be  executed 
over  the  lines  in  the  selected  range.  The  commands  are  <DELETE 
LINE>  and  replace. 

Text  Editor;  (TE) ,  subset  of  the  IISS  User  Interface  that 
consists  of  a  file  editor  that  is  based  on  the  text  editing 
functions  built  into  the  Form  Processor. 

Top  of  file;  the  first  line  of  the  buffer. 

User  Interface;  (UI) ,  IISS  subsystem  that  controls  the 
user's  terminal  and  interfaces  with  the  rest  of  the  system.  The 
UI  consists  of  two  major  subsystems;  the  User  Interface 
Development  System  (UIDS)  and  the  User  Interface  Management 
System  (UIMS) . 

User  Interface  Development  System;  (UIDS) ,  collection  of 
IISS  User  Interface  subsystems  that  are  used  by  applications 
programmers  as  they  develop  IISS  applications.  The  UIDS 
includes  the  Form  Editor  and  the  Application  Generator. 

User  Interface  Services ;  (UIS) ,  subset  of  the  IISS  User 
Interface  that  consists  of  a  package  of  routines  that  aid  users 
in  controlling  their  environment.  It  includes  message 
management,  change  password,  and  application  definition 
services . 


2-4 


UM  620344600 
30  September  1990 


Virtual  Terminal ;  (VT) ,  subset  of  the  IISS  User  Interface 
that  performs  the  interfacing  between  different  terminals  and 
the  UI.  This  is  done  by  defining  a  specific  set  of  terminal 
features  and  protocols  which  must  be  supported  by  the  UI 
software  which  constitutes  the  virtual  terminal  definition. 
Specific  terminals  are  then  mapped  against  the  virtual  terminal 
software  by  specific  software  modules  v/ritten  for  each  type  of 
real  terminal  supported. 
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SECTION  3 
FILE  EDITING 


3 . 1  Starting  an  Editing  Session 

The  Text  Editor  is  an  application  available  as  the 
SDTEZZZZZZ  function  in  the  IISS.  You  access  this  function  as 
explained  in  Section  4  of  the  IISS  Terminal  Operator  Guide. 

When  you  have  successfully  accessed  the  Text  Editor,  the  screen 
appears  as: 

-| - - - — - — - -  -  -  -  -  -  -  - - —  - — -  - - - - - - -  - - - 

I >>>>buf  bof<<<<  I 


>> 

Msg:  applcation 

+ - + 


The  last  two  lines  of  the  screen  contain  the  following 
information: 

o  The  command  line  (>>)  is  used  to  execute  command  mode 
commands  as  explained  in  other  sections  of  this  manual. 

o  Error  messages  and  some  help  is  displayed  in  the  message 
line. 

o  The  mode  field  shows  the  current  mode  of  the  keyboard. 

It  determines  which  function  keys  are  available  as 
explained  in  section  3  of  the  Terminal  Operator  Guide. 
This  field  value  is  changed  by  pressing  the  <M0DE>  key 
until  the  appropriate  value  is  displayed.  Unless 
otherwise  noted,  this  value  should  be  "applcation"  to  use 
the  TE  function  keys. 

The  general  functions  of  the  terminal  such  as  moving  the 
cursor,  inserting/deleting  characters,  and  refreshing  the 
screen  are  available  in  every  keyboard  mode  and  application. 

They  use  the  standard  keyboard  keys  and  are  documented  in 
section  3  of  the  Terminal  Operator  Guide. 

The  next  sections  explain  how  to  perform  the  Text  Editor 
functions . 
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3 . 2  Insert  Line 

When  creating  a  new  file,  the  workspace  buffer  is  zero 
lines  long.  Before  you  can  enter  text  into  the  buffer,  you  must 
insert  blank  lines  into  the  buffer  so  there  is  somewhere  to  put 
the  text.  This  is  also  true  when  you  want  to  add  text  to  an 
existing  file.  Blank  lines  are  inserted  into  the  buffer  using 
the  <INSERT  LINE>  key.  When  you  press  this  key,  the  line 
containing  the  cursor  and  all  the  following  lines  are  moved  down 
one  line.  The  last  line  displayed  on  the  screen  is  pushed  into 
the  nondisplayed  portion  of  the  buffer  and  the  line  containing 
the  cursor  is  filled  v/ith  blanks.  The  TE  does  not  permit  lines 
to  be  inserted  below  the  bottom  of  file  mark.  An  attempt  to  do 
so  aborts  the  function  and  a  warning  message  is  issued. 

The  next  example  shows  where  the  cursor  would  be  positioned 
after  pressing  the  <INSERT  LINE>  key.  The  key  can  be  pressed 
more  than  once  or  after  performing  the  REPEAT  command  to  insert 
several  blank  lines.  The  REPEAT  command  is  explained  in  another 
section  of  this  manual. 


+ - + 

>>>>buf  bof<<<< 


>> 

Msg  applcation 

+ - + 
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3 . 3  Entering  Text 

Whatever  you  type  on  the  keyboard  during  an  editing  session 
is  inserted  directly  before  the  cursor  as  text.  If  you  continue 
to  enter  text  past  the  right  margin,  the  cursor  will 
automatically  move  to  the  next  line.  The  line  will  break 
exactly  at  the  right  edge  of  the  screen.  You  are  responsible 
for  making  sure  there  are  blank  lines  for  the  cursor  to  move 
into.  Any  text  entered  on  or  following  the  bottom  of  file  mark 
is  lost. 


H - - - 1- 

This  example  shows  how  a  line  breaks  exactly  at  the  right  m 
argin  as  you  are  typing.  If  you  want  to  move  to  the  next  1 
ine  before  reaching  the  right  margin  and  possibly  splitting 
a  word,  you  must  press  the  <TAB>  key.  The  workspace  buffe 
r  contained  at  least  five  blank  lines  to  accept  this  text. 

>>>>buf  bof<<<< 


>> 

Msg:  applcation 

+ - + 


3 . 4  Midline  Break 

The  <MIDLINE  BREAK>  key  is  used  to  remove  all  the 
characters  from  the  cursor  position  to  the  end  of  the  line  and 
insert  them  at  the  beginning  of  a  new  line  immediately  following 
the  line  containing  the  cursor.  The  cursor  is  then  positioned 
at  the  beginning  of  this  new  line.  Pressing  the  <MIDLINE  BREAK> 
key  at  the  beginning  of  a  line  is  the  same  as  the  insert  line 
function . 

The  next  two  examples  show  how  your  screen  appears  before 
and  after  pressing  the  <MIDLINE  BREAK>  key  from  the  cursor 
position  shown. 
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- 

This  is  a  line  of  text  in  the  workspace  buffer. 

>>>>buf  bof<<<< 


>> 

Msg:  applcation 

+ - ^ 


H - )_ 

This  a  line  of  text 
in  the  workspace  buffer. 

>>>>buf  bof<<<< 


>> 

Msg:  applcation 

- - - 


A  midline  break  is  not  permitted  on  the  bottom  of  file  mark 
or  any  following  line.  If  attempted,  the  function  is  aborted 
and  a  warning  message  is  issued.  The  insert  line  function  is 
part  of  a  midline  break.  If  the  insert  line  fails,  the  midline 
break  will  also  be  aborted. 

A  midline  break  can  be  undone  using  the  fill  function  as 
described  in  another  section  of  this  manual. 

3 . 5  Delete  a  Line  of  Text 


The  <DELETE  LINE>  key  is  used  to  delete  the  characters  from 
the  current  cursor  position  to  the  end  of  the  line.  The  cursor 
is  moved  to  the  start  of  the  next  line.  If  the  cursor  was  at 
the  beginning  of  the  line,  all  lines  which  follow  are  scrolled 
up  one  line.  The  TE  does  not  permit  the  line  containing  the 
bottom  of  file  mark  or  any  following  lines  to  be  deleted.  An 
attempt  to  do  so  is  aborted  and  a  warning  message  is  issued. 
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The  next  two  examples  show  how  your  screen  appears  before 
and  after  pressing  the  <DELETE  LINE>  key  from  the  cursor 
position  shown. 


H —  —  —  —  —  —  —  —  — —  —  —  —  — - -  -  -  -  - - -  -  - - —  _  — 

This  is  a  line  of  text  in  the  workspace  buffer. 

>>>>buf  bof<<<< 


>> 

Msg:  applcation 

+ - + 


-i - —  —  —  — - — —  — —  —  — -  —  — - — -j_ 

This  is  a  line  of  text 
>>>>buf  bof<<<< 


>> 

Msg:  applcation 

+ - + 


One  of  three  things  happens  to  the  deleted  line. 

o  If  the  select  mode  is  on,  all  the  lines  in  the  selected 
range  replace  the  contents  of  the  cut  and  paste  buffer 
as  explained  in  the  section,  "Selecting  and  Moving 
Text" . 

o  If  the  previous  function  was  a  delete  line,  the  cursor 
has  not  been  moved  and  the  select  mode  is  off,  the  line 
is  concatenated  to  the  cut  and  paste  buffer. 


3-5 


UM  620344600 
30  September  1990 


o  If  the  previous  function  was  not  a  delete  line  or  the 
cursor  was  moved,  and  the  select  mode  is  off,  the  line 
replaces  the  current  contents  of  the  cut  and  paste 
buffer. 

Since  all  deleted  lines  either  replace  the  contents  of  the 
cut  and  paste  buffer  or  are  concatenated  to  it,  you  can  always 
undo  the  last  delete  function  by  using  the  paste  or  fill 
functions  as  explained  in  another  section  of  this  manual. 

3 . 6  Viewing  the  Workspace  Buffer 

The  functions  in  this  section  let  you  view  all  the  data  In 
the  workspace  buffer  when  it  contains  more  lines  than  the  size 
of  the  display  page.  When  using  these  functions,  you  should 
think  of  the  data  moving  around  behind  a  stationary  screen. 

3.6.1  First  Page 

The  <FIRST  PAGE>  key  is  used  to  display  the  first  n  lines 
of  the  workspace  buffer  where  n  is  the  terminal  display  size. 
The  cursor  is  positioned  on  the  first  character  of  the  file. 

The  next  two  examples  show  how  your  terminal  screen  appears 
before  and  after  pressing  the  <FIRST  PAGE>  key. 


Line 

34 

Line 

35 

Line 

36 

Line 

37 

Line 

38 

Line 

39 

Line 

40 

Line 

41 

Line 

>> 

Msg : 

42<FIRST  PAGE> 

applcat ion 
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Line 

1 

Line 

2 

Line 

3 

Line 

4 

Line 

5 

Line 

6 

Line 

7 

Line 

8 

Line 

9 

>> 

Msg: 

1  Top  of  File 

applcation 

.6.2 

Last  Page 

The  <LAST  PAGE>  key  is  used  to  display  the  last  n  lines  of 
the  workspace  buffer  where  n  is  the  terminal  display  size.  The 
cursor  is  positioned  at  the  bottom  of  file  mark.  The  next  two 
examples  show  how  your  screen  appears  before  and  after  pressing 
the  <LAST  PAGE>  key.  The  first  and  last  page  functions  are  only 
defined  within  the  context  of  the  Text  Editor. 


Line 

9 

Line 

10 

Line 

11 

Line 

12 

Line 

13 

Line 

14 

Line 

15 

Line 

16 

Line 

>> 

Msg : 

17<LAST  PAGE> 

applcation 
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+ - + 

Line  37 
Line  38 
Line  39 
Line  40 
Line  41 
Line  42 
Line  43 

>>>>buf  bof<<<< 


>> 

Msg:  1  Bottom  of  File  applcation 

+ - + 


To  review  the  other  pages  or  portions  of  your  file,  you  use 
the  scrolling  and  paging  keyboard  functions.  You  access  these 
by  putting  the  terminal  keyboard  into  the  IISS  "scrll/page"  mode 
as  explained  in  Section  3  of  the  Terminal  Operator  Guide. 

3 . 7  Selecting  and  Moving  Text 

This  section  describes  how  to  move  text  about  in  the 
workspace  buffer. 

3.7.1  Selecting  Text  to  Be  Moved 

There  are  two  ways  to  select  the  text  you  want  to  move. 

One  way  is  to  move  the  cursor  to  the  first  line  to  be  moved  and 
press  the  <DELETE  LINE>  key  for  the  n  consecutive  lines  to  be 
moved.  An  alternate  way,  which  is  more  convenient  when 
selecting  large  blocks  of  text,  is  to  go  into  select  mode  by 
pressing  the  <SELECT>  key.  From  this  point  you  have  the  option 
of  moving  the  cursor  forward  to  just  after  the  last  character  in 
the  text  to  be  moved  or  backward  to  the  first  character  in  the 
text  to  be  moved  and  then  pressing  the  <DELETE  LINE>  key.  In 
either  case,  all  text  between  the  select  line  marker  and  the 
cursor  is  stored  in  the  cut  and  paste  buffer. 

When  the  <SELECT>  key  is  pressed,  you  are  in  select  mode 
and  the  message  ">>>>>>SELECT  LINE«<<<<<"  is  inserted  on  the 
screen.  The  next  two  examples  show  how  your  screen  appears 
before  and  after  pressing  the  <SELECT>  key  from  the  cursor 
position  shown. 
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+ - + 

Line  1 
Line  2 
Line  3 
Line  4 
Line  5 

>>>>buf  bof<<<< 


>> 

Msg:  applcation 

+ - + 


+ - 

Line  1 
Line  2 
Line  3 

>>>>>>SELECT  LINE<<<<<<< 
Line  4 
Line  5 

>>>>buf  bof<<<< 


>> 

Msg:  1  Select  Active 


If  you  move  the  cursor  backward,  the  select  line  marks  the 
end  of  the  select  range  and  the  current  cursor  position  is  the 
beginning.  If  you  move  the  cursor  forward,  the  select  line 
marks  the  beginning  of  the  select  range  and  the  select  range 
will  end  just  before  the  current  cursor  position. 

The  select  mode  may  be  canceled  by  pressing  the  <SELECT> 
key  again  without  pressing  the  <DELETE  LINE>  key.  Select  mode 
may  be  entered  in  the  middle  of  a  line.  However,  it  may  not  be 
entered  at  the  bottom  of  file  mark  or  any  following  lines.  If 
you  attempt  this,  the  function  will  be  aborted  and  a  warning 
message  will  be  issued.  The  select  function  uses  the  insert 
line  function  to  display  the  select  line  message.  If  the  insert 
line  fails,  the  select  is  aborted. 
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3.7.2  Inserting  Text  from  the  Cut  and  Paste  Buffer 

To  insert  text  from  the  cut  and  paste  buffer,  move  the 
cursor  to  the  line  where  the  text  is  to  be  positioned  and  press 
the  <PASTE>  key  or  the  <ITLL>  key.  The  contents  of  the  paste 
buffer  will  be  inserted  just  before  the  line  containing  the 
current  cursor  position.  Note  that  the  position  on  the  screen 
of  the  lines  below  the  current  cursor  position  remain  unchanged. 
This  means  that  all  or  part  of  the  lines  above  the  cursor  and/or 
the  text  inserted  may  be  scrolled  up.  Also  note  that  the  lines 
of  text  remain  in  the  cut  and  paste  buffer  until  the  <DELETE 
LINE>  key  is  pressed  again  so  that  the  lines  may  be  inserted  in 
as  many  places  as  required. 

3. 7. 2.1  Using  the  Paste  Function  to  Insert  Text 

The  paste  function  restores  the  deleted  lines  of  text  in 
the  exact  format  they  were  in  when  deleted.  The  next  two 
examples  show  how  your  screen  appears  before  and  after  pressing 
the  <PASTE>  key  from  the  cursor  position  shown.  The  cut  and 
paste  buffer  contains  the  line  "This  line  is  in  the  cut  and 
paste  buffer". 


Line 

Line 

Line 

Line 

Line 


>>>>buf  bof<«< 


>> 

Msg: 


applcation 
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H - H 

Line  2 
Line  3 
Line  4 

This  line  is  in  the  cut  and  paste  buffer 
Line  5 

>>>>buf  bof<<<< 


>> 

Msg:  applcation 

+ - + 


3. 7*2. 2  Using  the  Fill  Function  to  Insert  Text 

The  fill  function  restores  the  deleted  text  by  reformatting 
the  contents  of  the  cut  and  paste  buffer  so  that  each  new  line 
is  filled  to  the  current  fill  margins  with  as  many  words  as 
possible  from  the  paste  buffer.  A  word  is  a  sequence  of 
nonblank  printable  characters.  The  MARGINS  command  allows  you 
to  define  the  margins  for  this  function  as  explained  in  another 
section  of  this  manual.  The  fill  function  can  be  used  to  clean 
up  extraneous  white  space  that  may  result  from  other  file  edits 
such  as  unwanted  midline  breaks  and  the  REPLACE  command. 

The  next  examples  demonstrate  the  fill  function.  The  first 
example  shows  how  the  screen  appears  before  executing  the  fill 
function  and  the  select  range  that  will  go  into  the  cut  and 
paste  buffer  when  the  <DELETE  LINE>  key  is  pressed. 

+ - + 

Line  1 
Line  2 

Line  3: first  line  of  select  range 
Line  4 

Line  5: last  line  of  select  range 
>>>>>>SELECT  LINE<<<<<<< 

Line  6 

>>>>buf  bof<<<< 


>> 

Msg:  applcation 

+ - + 


3-11 


UM  620344600 
30  September  1990 


The 
pressing 
from  the 
the  same 


next  two  examples  show  how  the  screen  appears  after 
the  <DELETE  LINE>  key  and  then  pressing  the  <FILL>  key 
cursor  position  shown.  Note  that  the  fill  margins  are 
as  the  workspace  buffer  margins  in  this  example. 


Line  1 
Line  2 
Line  6 

>>>>buf  bof<<<< 


>> 

Msg : 


applcation 


+ - 

Line  3: first  line  of  select  range  Line  4  Line  5: last  line 
of  select  range 
Line  6 

>>>>buf  bof<<<< 


>> 

Msg:  applcation 

-f. - + 


3 . 8  Quitting 

The  <QUIT>  key  either  ends  the  current  edit  session  or 
cancels  command  mode  and  returns  you  to  edit  mode. 

To  incorporate  your  edits  into  an  existing  file  or  to 
create  a  new  file  from  the  workspace  buffer,  you  must  execute 
the  SAVE  command  as  explained  in  another  section  of  this  manual 
If  the  workspace  buffer  has  been  modified  and  you  press  the 
<QUIT>  key  before  saving,  the  message  "Buffer  has  been  changed, 
use  <quit>  to  really  quit".  You  can  press  the  <QUIT>  key  again 
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to  exit  without  saving  or  press  any  other  function  key  to  return 
to  edit  mode. 

3 . 9  Executing  Command  Mode  Commands 

The  <C0MMAND>  key  is  used  to  switch  to  command  mode.  The 
cursor  then  moves  to  the  command  line  prompt  (») .  At  this 
point,  if  you  are  familiar  with  the  command  mode  commands,  you 
can  enter  the  desired  command  with  its  operands  and  press  the 
<ENTER>  key.  Operands  are  discussed  in  the  sections  explaining 
each  command. 


+ - + 

Line  1 
Line  2 
Line  3 
Line  4 
Line  5 

Line  6<COMMAND> 

>>>>buf  bof<<<< 


>>  save  curf ile<ENTER> 


I  Msg:  applcation| 

+ - + 


Command  names  may  be  abbreviated  as  long  as  enough 
characters  are  entered  to  keep  them  unique  (e.g.,  "se"  may  be 
entered  for  search) .  Each  command  or  operand  must  be  separated 
by  a  blank.  Operands  which  contain  a  blank  such  as  search  and 
replace  strings  must  be  enclosed  in  double  quotes  (") .  Examples 
of  this  will  be  shown  for  the  specific  commands  this  pertains 
to. 


When  a  command  has  completed  successfully,  you 
automatically  return  to  edit  mode  and  the  cursor  will  be  in  the 
same  text  position  it  was  in  when  you  first  pressed  the 
<C0MMAND>  key. 

You  can  also  execute  command  mode  commands  from  the  Command 
Mode  Menu.  This  menu  is  displayed  by  pressing  the  <HELP>  key 
from  the  command  line  prompt  (e.g.,  »  <HELP>)  or  by  leaving  the 
command  line  blank  or  blank  filling  the  command  line  and 
pressing  the  <ENTER>  key.  The  next  example  shows  the  Command 
Mode  Menu. 
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-I - 

Command  List 

Search:  _ 

Replace : 

Load: 

Save: 

Clear: 

Margins: 

Repeat: 

Buffer: 


>> 

Msg:  applcation 

+ - + 


To  execute  a  command  from  the  menu,  move  the  cursor  to  the 
field  with  the  desired  command,  enter  the  required  operands,  and 
press  the  <ENTER>  key.  The  next  example  shows  this. 

H - 1- 

Command  List 

Search : 

Replace : 

Load : 

Save:  curf ile<ENTER> 

Clear: 

Margins : 

Repeat : 

Buffer: 


>> 

Msg:  applcation 

+ - + 


If  you  put  the  cursor  on  the  desired  command  field  and 
press  the  <HELP>  key,  prompts  for  the  required  operands  appear 
below  the  menu.  This  appears  on  your  screen  as  shown  in  the 
next  example. 
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Command  List 

Search: 

Replace : 

Load: 

Save:  <HELP> 

Clear: 

Margins : 

Repeat : 

Buffer: 

Save  a  File 

Enter  File  Name: 


>> 

Msg:  applcation 

+ - + 


3.10  Searching  for  Text 

The  SEARCH  command  allows  you  to  find  the  first  occurrence 
of  a  given  text  string  and  positions  the  cursor  at  the  first 
character  of  the  string  in  the  workspace  buffer.  If  the  SEARCH 
command  is  followed  by  a  minus  (e.g.,  search  "text  string"  -) , 
the  search  will  be  done  backwards  from  the  current  cursor 
position  towards  the  top  of  the  file.  Otherwise,  the  search 
will  be  done  from  the  current  cursor  position  towards  the  end  of 
the  file.  The  text  string  you  are  searching  for  can  be  a 
maximum  of  40  characters  long  and  must  be  enclosed  in  double 
quotes  if  it  contains  spaces.  If  the  string  is  not  found,  the 
message  "String  not  found"  is  displayed  in  the  message  line  and 
you  remain  in  the  current  command  mode. 

3.10.1  SEARCH  Operands 

The  next  example  shows  how  the  prompts  for  the  SEARCH 
command  operands  appear  on  your  screen.  The  operands  entered 
the  last  time  the  search  command  was  executed  will  appear  as  the 
current  values  for  these  fields. 
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Command  List 

Search:  <HELP> 

Replace : 

Load: 

Save: 

Clear: 

Margins : 

Repeat: 

Buffer: 

Search  for  a  String 

Enter  String:  _ 

Search  Direction: 


>> 

Msg:  applcation 

+ - + 


The  format  for  executing  this  command  from  the  command  line 

is : 


>>  search  "search  string"  dir<ENTER> 

where  "dir"  determines  the  direction  of  the  search  (blank  for 
forward  or  -  for  backward. 

3.10.2  Finding  the  Next  Occurrence 

To  find  the  next  occurrence  of  the  text  string,  press  the 
<SEARCH  NEXT>  key.  The  search  will  continue  in  the  direction  it 
was  originally  executed  in.  Another  way  to  find  the  next 
occurrence  is  to  press  the  <ENTER>  key  at  the  SEARCH  command  on 
the  command  mode  menu  without  entering  any  operands.  The  search 
will  be  executed  using  the  operands  previously  entered. 

3.10.3  Considerations 

A  search  is  not  permitted  on  the  bottom  of  file  line  or  any 
following  line.  An  attempt  to  do  so  aborts  the  command  and 
issues  a  warning  message. 
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3.11  Replacing  One  Text  String  with  Another 

The  REPLACE  command  replaces  a  given  "old  string"  with  the 
specified  "new  string".  The  search  for  the  old  string  always 
begins  at  the  current  cursor  position. 

3.11.1  Specifying  the  Scope 

You  have  several  options  for  specifying  the  scope  of  the 
search  and  replace.  If  a  star  (*)  is  appended  to  the  command 
(e.g.,  replace  "old  string"  "new  string"  *) ,  the  replacements 
will  be  made  on  all  occurrences  from  the  cursor  to  the  end  of 
the  buffer.  If  a  period  is  appended  to  the  command,  the 
replacements  will  be  made  on  all  occurrences  from  the  cursor  to 
the  end  of  the  line.  Note  that  a  star  and  a  period  may  not  be 
used  in  the  same  command.  If  neither  of  these  options  is 
specified,  "new  string"  will  replace  the  first  occurrence  of 
"old  string"  to  the  right  of  the  current  cursor  position.  If  a 
minus  (-)  is  appended  to  one  of  the  above  commands  (e.g., 
replace  "old  string"  "new  string"  .  -) ,  the  replacements  will  be 
performed  backwards.  This  means  from  the  cursor  to  the  top  of 
the  file,  from  the  beginning  of  the  line  to  the  cursor,  or  the 
first  occurrence  to  the  left  of  the  cursor  respectively. 

If  you  define  a  select  range  replacements  will  be  performed 
on  all  occurrences  of  the  "old  string"  in  this  range.  The 
section,  "Selecting  Text  to  be  Moved"  explains  defining  a  select 
range . 

If  the  "old  string"  is  not  found,  a  message  is  displayed 
and  you  remain  in  command  mode. 

The  cursor  position  after  the  REPLACE  command  is  executed 
depends  on  the  scope  option  that  was  specified.  For  commands 
appended  with  no  option  or  a  period,  the  cursor  is  positioned 
just  after  the  last  text  replacement.  For  commands  appended 
with  a  star,  the  cursor  is  positioned  at  the  bottom  of  the  file 
or  at  the  end  of  the  select  range  if  that  form  of  the  command 
was  used. 

3.11.2  REPLACE  Operands 

The  next  example  shows  how  the  prompts  for  the  REPLACE 
command  operands  appear  on  your  screen. 
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+  — — —  + 

Command  List 

Search: 

Replace:  <HELP> 

Load : 

Save : 

Clear: 

Margins : 

Repeat : 

Buffer: 

Replace  One  String  with  Another 

Enter  Old  String:  _ 

Enter  New  String: 

Option: 

Direction: 


>> 

Msg:  applcation 

+ - + 


The  command  line  format  for  this  command  is: 

>>  replace  "old  string"  "new  string"  opt  dir<ENTER> 

where  "opt"  is  the  scope  option  and  "dir"  is  the  replacement 
direction  (blank  or  -) . 

3.11.3  Considerations 

A  line  that  is  longer  after  the  replacement  is  wrapped  and 
a  shorter  line  is  padded  on  the  right  with  blanks.  The 
extraneous  whitespace  this  may  cause  can  be  eliminated  by 
selecting  the  appropriate  range  of  text  and  using  the  fill 
function . 

A  replace  is  not  permitted  on  the  bottom  of  file  line  or 
any  following  line.  An  attempt  to  do  so  will  abort  the  command 
and  a  warning  message  is  issued. 

If  you  position  the  cursor  at  the  REPLACE  command  on  the 
command  mode  menu  and  press  the  <ENTER>  key  without  entering  any 
operands,  the  command  will  be  reexecuted  using  the  operands 
previously  entered. 
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3 . 12  Loading  a  File  for  Editing 

The  LOAD  command  inserts  a  file  into  the  workspace  buffer 
just  before  the  line  containing  the  current  cursor  position.  If 
you  execute  this  command  while  there  is  text  in  the  buffer,  the 
loaded  file  becomes  part  of  the  current  workspace  buffer. 

You  can  also  use  this  command  to  start  editing  a  new  file 
as  a  separate  entity  without  ending  your  current  editing 
session.  To  do  this  you  clear  the  workspace  buffer  using  the 
CLEAR  command  before  executing  the  LOAD  command.  You  may  also 
want  to  save  the  file  currently  in  the  workspace  buffer  before 
executing  the  CLEAR  command.  When  you  initially  access  the  Text 
Editor,  you  can  use  the  LOAD  command  without  the  SAVE  and  CLEAR 
commands  to  insert  an  existing  file  you  want  to  edit  into  the 
buffer.  You  must  press  the  <FIRST  PAGE>  key  to  display  the 
first  n  lines  of  the  file. 

3.12.1  LOAD  Operand 

The  next  example  shows  how  the  prompt  for  the  LOAD  command 
operand  appears  on  your  screen. 

+ - + 

Command  List 

Search: 

Replace : 

Load:  <HELP> 

Save: 

Clear: 

Margins : 

Repeat : 

Buffer: 

Load  a  File 

Enter  File  Name: 


>> 

Msg:  applcation 

+ - + 


The  command  line  format  for  this  command  is: 
>>  load  f ilename<ENTER> 
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3.12.2  Considerations 

The  LOAD  command  cannot  be  executed  if  the  current  cursor 
position  is  below  the  bottom  of  file  mark.  An  attempt  to  do  so 
will  abort  the  command  and  a  warning  message  will  be  issued. 

Failure  of  the  I/O  operations  open  file,  close  file,  and 
read  a  record  and  the  insert  line  function  will  also  cause  the 
load  command  to  abort  and  a  warning  message  will  be  issued. 

The  name  of  the  loaded  file  does  not  become  the  default 
save  name.  A  file  name  must  be  specified  when  the  workspace 
buffer  is  saved  or  you  can  use  the  BUFFER  command  to  set  or 
change  the  default  save  name  as  explained  in  another  section  of 
this  manual. 

3.13  Saving  the  Workspace  Buffer 

The  SAVE  command  writes  the  contents  of  the  workspace 
buffer  to  the  file  name  specified-  If  no  file  name  is  given, 
the  buffer  is  written  to  the  current  buffer  name.  The  current 
buffer  name  is  either  the  name  of  the  file  specified  when  the  TE 
was  accessed  or  the  buffer  name  specified  by  executing  the 
BUFFER  command. 

3.13.1  SAVE  Operand 

The  next  example  shows  how  the  prompt  for  the  SAVE  command 
operand  appears  on  your  screen. 
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H - - - - - - - — - 1- 

Command  List 

Search : 

Replace : 

Load; 

Save:  <HELP> 

Clear: 

Margins : 

Repeat: 

Buffer: 

Save  a  File 

Enter  File  Name: 


>> 

Msg:  applcation 

+ - + 


The  command  line  format  for  this  command  is: 

>>  save  f ilename<ENTER> 

When  the  SAVE  command  is  complete  the  cursor  returns  to  position 
it  was  in  before  you  went  into  command  mode. 

3.13.2  Considerations 

If  the  I/O  operations  open  file,  close  file  and  write  a 
record  fail,  the  save  command  is  aborted.  The  state  of  the  file 
on  such  a  failure  is  system  dependent. 

If  no  file  name  is  supplied  and  there  is  no  buffer  name 
(default  save  name)  when  the  SAVE  command  is  executed,  a  message 
is  displayed  and  one  remains  in  the  current  command  mode.  This 
condition  results  if  the  file  was  brought  into  the  TE  using  the 
LOAD  command  and  the  workspace  buffer  was  empty. 

3.14  Clearing  the  Workspace  Buffer 

The  CLEAR  command  deletes  all  lines  between  the  top  of  file 
and  bottom  of  file  marks.  The  lines  become  the  current  contents 
of  the  cut  and  paste  buffer.  The  CLEAR  command  can  be  undone 
using  the  paste  function  and  naming  the  buffer. 

This  command  is  useful  if  you  want  to  edit  another  file  as 
a  separate  entity  during  your  current  edit  session.  To  do  this 
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you  would  first  save  the  current  workspace  buffer  and  then 
execute  the  CLEAR  command.  Then  execute  the  LOAD  command  to 
insert  the  new  file  into  the  workspace  buffer  and  change  the 
default  save  name  using  the  BUFFER  command. 

The  CLEAR  command  has  no  operands  or  considerations. 

3.15  Setting  the  Fill  Margins 

The  MARGINS  command  is  used  to  set  the  left  and  right 
margins  that  will  be  used  when  the  fill  function  is  executed. 

The  margin  values  must  satisfy  the  constraint: 

0  <=  "left  margin"  <  "right  margin"  <=  display  width  +  1 

This  means  that  if  the  left  margin  is  9  and  the  right  margin  is 
70,  each  line  printed  can  have  up  to  60  characters  in  columns  10 
through  69.  The  default  fill  margin  values  are  the  same  as  the 
margins  that  control  the  width  of  the  display  page.  For  a  VTIOO 
terminal,  the  display  width  is  79  so  the  default  fill  margin 
values  are  0  and  80. 

3.15.1  MARGINS  Operands 

The  next  example  shows  how  the  prompts  for  the  MARGINS 
command  operands  appear  on  your  screen. 

—  —  _  — 

Command  List 

Search: 

Replace : 

Load: 

Save : 

Clear: 

Margins:  <HELP> 

Repeat: 

Buffer: 

Set  Fill  Margins 

Left  Margin:  _ 

Right  Margin: 


>> 

Msg:  applcation 

+ - + 
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The  command  line  format  for  this  command  is: 

>>  margins  Im  rm<ENTER> 

where  "Im"  is  the  left  fill  margin  value  and  "rm"  is  the  right 
fill  margin  value. 

3.15.2  Considerations 

The  margin  values  set  with  this  command  are  only  used  by 
the  fill  function.  The  workspace  buffer  margins  are  permanently 
set  based  on  terminal  type.  For  example,  on  a  VTIOO,  the 
margins  are  0  and  80. 

3.15.3  Example  Showing  Affects  of  Setting  Fill  Margins 

The  next  examples  demonstrate  the  fill  function  when  the 
fill  margins  have  been  set  to  0,28.  The  first  example  shows  how 
the  screen  appears  before  the  fill  function  and  the  select  range 
that  will  go  into  the  cut  and  paste  buffer  when  the  <DELETE 
LINE>  key  is  pressed  from  the  cursor  position  shown. 

H - h 

Line  1  of  the  workspace  buffer. 

Line  2  of  the  workspace  buffer. 

Line  3: first  line  of  select  range 
Line  4  of  the  workspace  buffer. 

Line  5: last  line  of  select  range 
>>>>>>SELECT  LINE<<<<<<< 

Line  6  of  the  workspace  buffer. 

>>>>buf  bof<<<< 


>> 

Msg:  applcation 

+ - + 


The 
pressing 
from  the 


next  two  examples  show  how  the  screen  appears  after 
the  <DELETE  LINE>  key  and  then  pressing  the  <FILL>  key 
cursor  position  shown. 
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3.16  Repeatinq  a  Command  or  Function  Ke-\ 


The  REPEAT  command  allows  you  to  specify  that  the  next 
command  executed  or  function  key  pressed  will  automatically  be 
repeated  a  specified  number  of  times.  When  yov.  execute  this 
command,  the  message  "in  repeat"  is  displayed  in  the  message 
line.  You  do  not  return  to  edit  mode  until  after  you  press  the 
desired  function  key  or  execute  the  desired  command.  When  the 
last  repetition  has  completed,  the  message  "operation  complete" 
is  displayed  in  the  message  line  and  then  you  return  to  edit 
mode.  The  function  keys  that  are  supported  by  the  REPEAT  command 
are  <INSERT  LINE>,  <DELETE  LINE>,  <FIRST  PAGE> ,  <LAST  PAGE>, 
<PASTE>,  <FILL>,  <MIDLINE  BREAK>,  and  <QUIT>.  However,  the 
<FIRST  PAGE>,  <LAST  PAGE> ,  and  <QUIT>  functions  will  only  be 
executed  once.  The  cursor  position  after  the  the  last 
repetition  has  completed  depends  on  the  function  or  command 
performed.  Pressing  the  <QUIT>  key  essentially  cancels  the 
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repeat  command  and  the  cursor  is  returned  to  the  position  it  was 
in  before  going  into  command  mode. 

3.16.1  REPEAT  Operands 

The  next  example  shows  how  the  prompt  for  the  REPEAT 
command  operand  appears  on  your  screen. 

H — - —  —  — - — - — - - - 1_ 

Command  List 

Search: 

Replace : 

Load: 

Save: 

Clear: 

Margins : 

Repeat:  <HELP> 

Buffer : 

Repeat  Command/Function 
Enter  Repeat:  _ 

>> 

Msg:  applcation 


The  command  line  format  for  this  command  is: 

>>  Repeat  n<ENTER> 

where  "n"  is  the  number  of  times  you  want  to  repeat  the  command 
or  function. 

3.16.2  Considerations 

The  number  of  repetitions  must  be  greater  than  zero.  If  it 
is  not,  the  command  or  function  is  aborted  and  a  warning  message 
is  issued. 


$ 
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3.17  Naming  the  Workspace  Buffer 

The  BUFFER  command  allows  you  to  specify  a  default  file 
name  for  the  SAVE  command.  This  is  the  file  the  workspace 
buffer  will  be  written  to  if  you  execute  the  SAVE  command 
without  giving  a  file  name.  This  name  overrides  the  default 
save  name  that  was  set  if  a  file  name  was  specified  when  the  TE 
was  accessed. 

3.17.1  BUFFER  Operand 

The  next  example  shows  how  the  prompt  for  the  BUFFER 
command  operand  appears  on  your  screen. 

H - - - -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  - - —  — - -  -  -  -  -  -  - - 1_ 

Command  List 

Search: 

Replace : 

Load : 

Save : 

Clear: 

Margins : 

Repeat : 

Buffer:  <HELP> 

Buffer  Name 
Enter  Buffer  Name: 


>> 

Msg:  applcation 

+ - + 


The  command  line  format  for  this  command  is: 
>>  buffer  f ilename<ENTER> 

The  BUFFER  command  has  no  considerations. 
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APPENDIX  A 

FORM  PROCESSOR  (FP)/TEXT  EDITOR  (TE) 
CALLABLE  INTERFACE 


The  TE  callable  interface  allows  access  to  the  TE  file 

editing  capabilities  (as  described  in  the  TE  DS  and  UM)  from  a 

program.  The  calling  requirements  are  as  follows: 

void  editci (f ile_name,  changed) 
char  f ile_name[30] ; 
int  ^changed; 

The  filename  is  a  thirty  character  string  with  the  name  of 

the  file  to  be  brought  into  the  buffer  for  editing.  It  must  be 

blank  filled  in  all  languages  except  C. 

The  changed  flag  is  set  to  true  if  the  buffer  is 
subsequently  modified  and  saved,  else  it  is  set  to  false. 

Notes : 

1.  The  FP  procedure  initfp  must  be  called  before  the  first  call 
to  editci. 

2.  Since  the  TE  is  essentially  an  FP  application  all  messages 
are  directed  to  the  message  line  of  the  screen. 

3.  When  linking  in  editci  the  usual  FP  and  VTI  linking 
requirements  are  to  be  used  as  well. 

4.  When  running  an  application  with  editci  the  usual  FP  and  VTI 
run  time  requirements  hold. 
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